Api.ConfigureDc 方法

配置分布时钟 (DC) 选项。分布时钟允许从站周期与 KINGSTAR 周期同步,强烈建议任何运动应用程式皆需避免震动。

命名空间IntervalZero.KINGSTAR.Local.Api

组合: IntervalZero.KINGSTAR.Local.Api (于 IntervalZero.KINGSTAR.Local.dll) 版本:4.4.0.0

语法

C#VB
public KsError ConfigureDc(
       bool Active,
       bool CheckStatus,
       bool MasterShift,
       int ReferenceIndex
)
Public Function ConfigureDc(
       Active As Boolean,
       CheckStatus As Boolean,
       MasterShift As Boolean,
       ReferenceIndex As Integer
) As KsError

参数

Active

型别:bool

true:启用 DC 同步;false:停用 DC 同步。预设为 true

 

CheckStatus

型别:bool

启动时启用 DC 抖动检查。同步完成后,装置会切到运作状态 (Op),此将会使启动过程增加 15 秒,预设为 true

 

MasterShift

型别:bool

选择偏移模式。true:主站偏移;false:总线偏移,预设为 false

总线偏移表示 EtherCAT 从站跟随主站(电脑)时钟;主站偏移表示从站与主站跟随称作 "参考时钟 (Reference Clock)" 的从站时钟。依预设,参考时钟为总线上第一个支援 DC 功能的从站。

注意:从站时钟相较于电脑时钟准确,因此主站偏移较为稳定。然而,主站偏移会修改电脑时钟的速度,此将影响电脑上所有的时间戳记,若电脑上同时使用其他通讯协定,此将产生问题。

 

ReferenceIndex

型别:int

选择作为参考时钟的装置。此参数为从站 ID,即装置的 EtherCAT ID,其对应于装置在 EtherCAT 回路中的位置。此 ID 以 0 为起始且不受别名影响。

注意:ReferenceIndex 尚未实作。

回传值

型别:KsError

方法的回传代码。

备注

可用的 EtherCAT 状态

ecatOffline

范例

C#
N/A

参见

Api 类别

IntervalZero.KINGSTAR.Local.Api 命名空间